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WALKY TALKY Do features such as a 
mouse/ trackball and a voice recognition 
facility mean that the Apricot Portable is a 
micro that’s going to go far? 






FIRST WORDS 






computing terms 


PROGRAMMING PROJECTS 


DIGITAYA At last, the full listing of the 
adventure game at the heart of our project: 
now its up to you to rescue the mysterious 
Digitaya from the evil clutches of the 


machine... 






system routines 


BRIDGING THE GAP Full instructions 
for building the Spectrum interface that will 
allow you to control our Workshop robot 





JOYSTICK JURY Our guest critic 
examines three games for Commodore 64 


animal lovers 


COMPUTER TUTOR Our introduction to 
a series on computers and education traces 
the rapid contemporary increase in the use 
of micros in schools 


FORWARD PROJECTION Microsoft 
Project is a management planning program 
for the IBM PC and compatible machines. 
We put it through its paces 











ur PASCAL course gets 
down to business: we introduce the concepts 
of identifiers and syntax diagrams, list the 
language’s 35 reserved words and write our 
first simple programs 


FROM LOOP TO MACHINE 
INDEPENDENT A weekly glossary of 





FILED AWAY Weconcludeour 
investigation of the BBC Micro’s OS filing 


Next Week 


@The CX5M from Yamaha is 
an MSX computer that is sold 
as a musical instrument. We 
examine this hybrid machine. 
@“The Word” Processor is a 
software package on 7 disks 
that contains all the text of 


the King James Version of the 


Bible. We take a look at this 
remarkable program. 
eContinuing our series on 
computers and education, we 
look at the problems involved 
in teaching young children 
using micros. 
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In the second instalment of our tutorial 
series on PASCAL we run through some of the 
fundamentals of its syntax and vocabulary. 
Programmers are weaned off the familiar 
lbut less efficient characteristics of BASIC with 
examples that demonstrate the disciplined 
structure and economy of the language. 


EE 


The problem normally encountered first when 
using a compiled language is learning to cope with 
the multi-stage process required to obtain even a 
small executable program. First, the source text 
has to be entered via some form of text editor or 
word processor. Then, having saved the source on 
tape or disk, the language compiler must be 
loaded and instructed to compile the source to 
some form of machine code (often with a complex 
string of command line options). Lastly, this 
‘object’ file must be re-located and linked with any 
run-time library routines needed. Possibly the 
program can be loaded and run without further 
effort, but should the compiler use a ‘pseudo- 
code’ or intermediate code, then a run-time 
interpreter must be used to execute the program. 

If all this sounds a little too formidable, take 
comfort from the fact that all the PAscAL packages 
available for home computers avoid these 
problems to a large extent. At the very least during 
program development your source text, compiler 
and object program can be co-resident in memory. 
PascaL’s efficiency and small size makes this 
possible, and the resulting system is often no more 
complicated in use than a resident BAsic package. 
It’s only when we start writing programs of any 
significant size that we need to resort to the more 
complicated processes described above. 

Each system will have its own set of commands 
to control the editor and compiler, and you must 
refer to the relevant documentation for help with 
these. Very often, a simple E for edit, C for compile 
and R for run will be all that is required. What 
concerns us is the correct syntax to be entered for 
every program, no matter how trivial or complex. 
Fortunately, PASCAL is so well standardised that 
there will be little or no need for the many 
programming ‘flavours’ that we have given in the 
past to deal with the different dialects of BAsIc 
(although later in the course we will have to deal 
with some minor exceptions). So let’s look at our 
first complete PASCAL program: 


Program First (output); 
Const 

Message = ‘Pascal Programming ; 
Begin 
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write (Message) 
End. 


Before we study this example in depth, try 
entering, compiling and running it. If you get any 
complaints from the compiler, read the error 
message carefully and see if you can spot what’s 
wrong. Every symbol must be presented exactly as 
shown. Take special care with the semi-colon at 
the end of the first and third lines and the full stop 
at the end of the program. When you have 
successfully executed this program you will see the 
following message displayed on the screen: 


Pascal Programming 


The program may be trivial but it demonstrates the 
overall form that every PASCAL module (program, 
procedure or function) will have. There are three 
separate parts: 


1. The heading, in this case a program heading. 
2. Declarations and definitions, here a single 
constant definition. 

3. The ‘body’, which contains all the executable 
statements. 


The syntax requirements of PASCAL, at least for the 
fundamentals of the language, may best be 
defined by means of ‘syntax diagrams’. These are 
like the road map of a one-way system. A legal 
route through the diagram proceeds from top left 
to bottom night, and every box that we pass 
through is either a ‘syntactic entity’ (that is, it 
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represents itself) contained in a round-edged box, 
or another item described elsewhere by a separate 
syntax diagram, indicated by the rectangular box 
in which it is enclosed. 


Statement 








Referring first to the overall diagram of a program, 
it can be seen that the words Begin and End are 
defined to be part of pAscAL’s vocabulary, and 
require no further diagrams to elaborate their 
meaning. In fact, PASCAL recognises only 35 words 
as having a fixed meaning, and for the sake of 
completeness we list all of them here. Our first 
program makes use of only four of them — 
Program, Const (short for constant), Begin and End. 
The word following Program is an ‘identifier’ that 
identifies the program’s name and can be any legal 
identifier you choose. 

If we start with a letter and use only letters or 
digits there are an almost infinitely large number of 
names we could use. Predictably, however, it is 
impossible to use a reserved word. For example: 


Name 

PASCAL 

ProgramOne 

N 

XYZ123 

Address12 
FloraMacDonald 
AVeryLongldentifierIndeed 


are all legal, whereas: 


Prog-1 

TEN% 
Lumber.Jack 
and 
TimeSSquare 
IDontKnow 
1001 Dalmatians 
It figures 


are illegal, either because they contain symbols 
which are not alphanumeric, start with a number 
or (in the case of and) duplicate one of pascaL’s 
reserved words. The last example is illegal because 
a space is used to separate the words, each 
component word (It and figures) being quite legal. 
In PASCAL, as in English, there is no difference in 
meaning between lower-case letters and capitals, 
though some non-standard versions may insist on 
reserved words being in upper case. 





% 


Apart from spaces and the end ofa line, there is 
another item of PASCAL syntax that can be used as a 
separator — a comment. This may appear 
anywhere in the text except, of course, in the 
middle of words. Comments are delimited by 
‘brace’ (curly bracket) symbols. 

Let’s be a little more adventurous and enter 
something that looks like a real PASCAL program: 


Program Program Two (input, output); 
{Gives the square of a number] 


Const 
Prompt ='Enter a number:’; 
Var 
number : integer: 
Begin 
WriteLn: 
WriteLn; 


write (Prompt): 

read (number); 

WriteLn (number, ° squared is’ number * number) 
End. 


Notice that we now include the identifier input in 
the heading. Input and output are required in 
PASCAL, and they identify the external files with 
which the program will communicate. Normally 
on a micro they will be the keyboard and VDU 
screen respectively. By including input, we can now 
read from the keyboard using the standard PASCAL 
procedure read. As with write, any ‘parameters’ 
must be listed in brackets. 

The memory used to store these parameters is 
reserved by the Var declaration, in this case for a 
single whole number. Unlike Basic, which can 
usually distinguish only between numbers and 
strings (by using a dollar sign after the identifier), 
PASCAL has an almost unlimited range of data types 
available. It therefore becomes important to let the 
compiler know how much memory to reserve for 
storage of each data item. You must always 
declare every single variable in a Var declaration. 

The cursor will remain positioned immediately 
after the prompt as if we had used a Basic PRINT 
statement with a final semi-colon. This is not a bug 
but exactly what we asked for by using PASCAL’s 
built-in write procedure. Whenever a new line is 
required, we must use the alternative procedure 
WriteLn. The Ln is a contraction of the word Line, 
and it is helpful to use a capital W and L to indicate 
the start of each of the component words. A 
simple WriteLn statement without parameters will 
merely create a new line. 

PascaL enables us to differentiate between data 
that varies and items that will remain constant 
throughout the execution of the program. Notice, 
therefore, that the Const definition uses an equals 
sign, whereas the Var declaration uses a colon. | 
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FORWARD 
PROJECTION 





In the previous instalment of our vertical 
software series, we looked at MacProject, a 
powerful graphics program for the Apple 
Macintosh that applies the principles of 
critical path analysis to long-term project 
management. Here, we look at a similar 
application for MS-DOS machines, such as 
the IBM and its compatibles. 





Although Microsoft's s Project package does not 
have the sort of graphics capabilities of 
MacProject — or of rival Digital Research’s 
Graphics Environment Manager program — it 
makes the best possible use of the IBM system’s 


limited graphics potential. For instance, 
combining equals signs or dashes with greater than 
symbols can result in some useful arrows: 


The first can be shown in bold to signify critical 
paths, and the second in a lightweight print to 
‘show those activities that are not critical. The 

salient factors that have to be considered, 
however, are more involved than this. They are: 


@ How flexible is the program, and how responsive 
is it to the sort of changes likely to become 
necessary as the project develops? 

@ How clearly does it display the relationships 
between activities, and does this assist in efficient 
management of the project? . 

@ Is it possible to use the program as an aid in the 
initial planning, or must users fully develop their 
ideas first? 


To answer the last question first, the user really 
needs to sort out the project on paper before 
keying in the first activity. Indeed, the manual 
states quite unequivocally: 


‘Before you enter activities into Microsoft Project, 
you need the following information about each 
activity: 

What it is (description) 

How long it takes (duration) 

What has to be done beforehand 

(predecessors) 

When it starts (start date).’ 


To emphasise the importance of such preparation, 
the manual offers a 10-page appendix, “Defining 
Tasks by a Work Breakdown Structure’, which 
states, amongst other things: 


‘Successful project management starts at the 
beginning of a project. First, you must state clearly 
the project’s goals, purpose, constraints, and 
specifications. Then you must define the set of 
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specific activities that constitute the project. 

‘No computer program can compensate for 
inadequately or inaccurately defined activities. 
Activity definitions may have implications for 
resource scheduling, allocation and control, and 
for budget and cost control. Inaccurate definition 
of activities is likely to result in serious problems 
once the project begins.’ 


Few of those experienced in management 
techniques would quarzvel with the necessity for 
adequate preparation. But those who see the 
computer as a qualitatively different tool from all 
others, acting as an extension of the user’s mind 
rather than of the fingertips, might feel that 
software’s task is precisely to help in avoiding 
inadequately or inaccurately defined activities. 
But Microsoft Project certainly helps the user to 
get the priorities right. Including the initial 
recourse to pen and paper, it also gives the user 
plenty of opportunities for changes. 

When the computer is first turned on, the date 
and time, which are set as part of the sign-on 
sequence, will determine the calendar used by the 
program — but the calendar can be changed quite 
easily, even after several activities have been typed 
in. If the time allocated to any activity is altered, as 
soon as the change has been input, the path 
diagram is recalculated changing some activity 
ae to bold ===> (critical), others to light 
> (non-critical). This not only makes the 
relationship between activities very easy to 
observe, but it also instantly highlights a change 
that may not otherwise be obvious to the user. It 
would appear from this that Microsoft have 
applied their experience in producing Multiplan, 
one of the most successful spreadsheets since the 
genre was pioneered by Visicalc in 1979. In fact, 
using Microsoft Project is rather like using a 
spreadsheet, and anyone familiar with using one 
will find themselves at home with Project almost 
immediately. 


USING MICROSOFT PROJECT 


After a brief display of the Microsoft logo, the 
activities screen is displayed (it is blank if no 
filename has been specified), with numbers from 
one to 19 down the left of each row and the 
timescale along the top, beginning with today’s 
date if that was input initially. This may be changed 
with the OPTIONS item on the menu along the 
bottom of the screen — again in the style of 
Multiplan — which also includes: _ 


BLANK CALENDAR DELETE EDIT GOTO HELP INSERT 
MOVE PRINT QUIT RESOURCE SORT TRANSFER 
XTERNAL 


Beneath the legend ‘Select option or type 
command letter’, the current option in use is 
displayed (initially ACTIVITY) and at the bottom 
right corner, the name of the Project in use, 
automatically given the title TEMP until the user 
names it otherwise. 

The timescale may be calibrated in days, weeks 
or months, and this may be changed at any time to 
assist in viewing the entire project at a glance. With 
a daily timescale, only the dates between 1 
January and 2 March, say, can be seen, whereas a 
monthly timescale permits two years and three 
months to be seen at once. The right and left 
cursor control keys are used to scroll the 
ACTIVITYscreen sideways, in the usual spreadsheet 
manner. Using the CALENDAR option, the user 
programs in holidays and other non-working days 
first; Saturdays and Sundays are normally 
scheduled as non-working. This can be changed, 
however, but it has to be done for each individual 
day. Later months can be displayed with the 
<PAGE DOWN=> key, and previous months can be 
returned to with <:PAGE UP>. 

Like most date options with IBM and 
compatible machines, care must be taken to utilise 
the American order of MM/DD/YY (for 
instance, 01/07/85 is 7 January 1985, not 1 July 
1985). Once the calendar has been adjusted, it can 
be SAVEd using the TRANSFER option in usual 
Multiplan style. The program adds the suffix .CAL 
to distinguish it from activity files (suffix .ACT) and 
resource files (.RES). 

The user then begins to type in activities, the 
time taken for each, and states the preceding 
activities it depends on — its ‘predecessors’ — with 
multiple dependencies separated by commas. The 
column for Activities Titles is limited to 15 
characters, and this may not be widened. 
However, if more than 15 characters are typed in, 
they will be held in memory and included in any 
hard copy print-out. As each activity is typed in — 
with its duration, predecessor(s) and start date — 


the relationships between'the various activities are 
immediately displayed, with slack time (the 
amount an activity can be delayed without 
delaying the total project) represented as dots. At 
this point, resources are allocated also. As soon as 
any resource has been entered, it is possible to call 
up the Resource Table to monitor the results. 

When the data has been entered, the complete 
schedule can be printed out on a page-by-page 
basis. But if a graphics card has been fitted and the 
appropriate printer connected (IBM PC’s 
graphics printer or Epson’s MX-80, MX- 100, FX- 
80 or FX-100), it is possible to have the whole 
project plan turned sideways and printed along 
the length of the paper. This is useful, as it means 
that a full plan can be printed out, without needing 
to cut-and-paste printouts. It is also possible to 
obtain detailed reports on each of the activities, 
showing the earliest and latest start and finish 
times, the resources, predecessors, and slack 
times, and a table of activities for the entire project 
displaying the same information in less detail. 

In practice, the lack of sophisticated graphics in 
the Microsoft Project is less of a disadvantage than 
might be initially thought, and though the 
excellent manual rightly emphasises the necessity 
of adequate pre-planning, it is still possible to 
adjust the information after second or third 
thoughts — or unexpected delays. The program 
will be particularly friendly to anyone experienced 
with spreadsheets, especially Multiplan, because 
its method of operation is very similar. It is faster in 
operation than the Macintosh MacProject, but 
then it is almost three times the price. 








Construction Project 

This chart represents a plan for 
the construction of a house. 
Dates appear across the top of 
the chart, and each task 
appears, in the order of 
Operation, along the left-hand 
edge. The duration of each task 
is represented with arrows 
constructed from keyboard 
characters (<< > . =-) 
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Going in Circles 

The diagram shows three 
common conditional loop 
structures. WHILE...WEND and 
REPEAT...UNTIL have certain 
similarities, but the loop 
termination test is performed in 
different places in each 
structure 


LOOP 


In programming, a loopis a branch to a previously 
defined section of the program. There are two types 
of programming loops — ‘conditional’ and 
‘unconditional’. 

In a conditional loop, the program will 
continually follow the loop until a certain condition 
is fulfilled. Conditional loops are vital components 
in the construction of structured programs. A wide 
variety of these have been developed for BAsic 
programs. Examples are: DO LOOP...UNTIL, 
WHILE...WEND, REPEAT...UNTIL and FOR ...NEXT. 

An unconditional loop will continually jump back 
to a defined area of the program. Since there are no 
conditions to be fulfilled, there is no option to break 
out of the loop. In BAsic, unconditional loops are 


created by using the GOTO statement to send the 


program execution back to a previous area of code 
— for example, 10 GOTO 10. 





LOW-LEVEL LANGUAGE 


Programming languages are 
compromises between two imperatives. On the 
one hand — for maximum efficiency — the 
language should reflect the actual workings of the 
processor; and on the other hand, it should be as 
intelligible as possible. A language whose 
commands correspond closely to the instruction 
set of the microprocessor is called a low-level 
language. Because the language is so closely 
linked with specific operations within the 
computer, a low- level language requires little, if 
any, interpretation. This produces a 
corresponding acceleration in the computer’s 
functioning. 

Examples of low-level languages are 
hexadecimal machine code and Assembly 
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senerally 


language. However, it should be pointed out that 
there is no sharp distinction between a high- and a 
low-level language. For example, while FoRTH 
commands do not correspond to the instruction 
set of the processor, the sequence of commands 
closely follows that of the processor. 


MACHINE CODE 


Machine code is the language directly understood 
by a computer’s microprocessor. Unlike higher 
level languages such as BASIC, machine code 
programs do not have to be translated by an 
interpreter or compiler for the machine to 
understand them. A CPU can perform only a 
limited range of very simple functions, such as 
adding two digits. To accomplish more difficult 
tasks, like multiplication, requires a set of 
instructions that combines these very simple 
functions. 

Machine code programs are made up of simple 
operations that transfer bytes of memory into the 
CPU’s internal registers, process them, and then 
return them to a specified location in memory. 
Instead of using words like PRINT or GOTO, 
machine code programs manipulate individual 
bits or bytes of memory — using the simple logic 
functions such as AND, OR, and NOT, and 
performing simple binary arithmetic. These 
operations are not intuitive, and they require a 
detailed knowledge of the computer’s memory 
locations and internal registers. This makes 
machine code programming a _ daunting 
proposition for many people, and problem- 
solving a long and arduous task. 

The advantage of programming in machine 
code over BAsic and other high-level languages is 
the speed with which operations can be carried out 
— direct access to the CPU makes this possible. 
Graphics routines in arcade games nearly always 
rely on machine code to a certain extent precisely 
because such speed is required. Still, BAsic and 
other languages do some things very well, so it is 
common to find many programs written largely in 
BAsIc that refer to machine code routines only for 
specific functions. 


MACHINE INDEPENDENT 


Most software is designed to run on a specific 
machine that has a set of carefully defined 
characteristics. Because of the lack of 
standardisation in the microcomputer industry, 
programs written to take advantage of, for 
example, the graphics characteristics of the 
Sinclair Spectrum, have to be completely 
rewritten if they are to run on the Commodore 64. 
Some programs, however, are written in such a 
way as to be independent of the unique qualities of 
a particular machine, and can therefore run 
equally well on a variety of computers. Software of 
this type is machine independent, and is also 
referred to as ‘portable’ software. This portability 
is generally possible only between machines that 


have a common operating system, such as CP/M 
or PC/DOS. 
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APRICOT PORTABLE/HARDWARE — 
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ACT (Apricot) has exploited the latest 
technology to give its compact Portable a 
futuristic feel: cable-free links between 
components, response to vocal commands 
and versatile mouse/trackball input. 
However, it has drawbacks that for the 
business user may offset these facilities. 


The portable machine represents one of the major 
growth areas in microcomputing. The idea is that 
the businessman can carry his micro around the 
world and work wherever there is a suitable power 
supply. In practice this is not always how the 
machine is used. Often a portable computer will 
be kept at home and work from a compatible 
machine is taken home in the evening to be 
completed on it. 

ACT (Apricot) is one of the latest of a long line 
of computer manufacturers to produce a portable 
machine that is compatible with its best-selling line 
of desk-top computers. 

The Apricot Portable is supplied within a sturdy 
plastic carry case about the size and shape of an 
attache-case but with a bulge at the bottom to 


accommodate the computer screen. The case is 


opened by pressing two clips on either side of the 
handle, although on the review machine this 
proved rather difficult. 


HARDWARE ANALYSIS 


Inside, the keyboard and computer are held on 
either side of the case by straps. Also provided 
within the case are two manuals, a microphone 
and a mouse/trackball. Unusually, no cable is 
provided to attach the keyboard and the mouse to 
the computer. This is because the data is 
transmitted via an infra-red beam. Data is 
transmitted and received by two small bulbs on the 
back edge of the keyboard and on the front of the 
mouse. Signals from these devices are picked up 
by a large focusing bulb on the computer. Thus, it 
is possible for the user to operate the keyboard on 
his lap and position the computer several feet 
away on a table. 

There are two disadvantages to this infra- 
red system. First, if several Apricot Portables are 
running in the same room the infra-red signals 
from different machines may interfere with each 
other. To avoid this, Apricot has made a light tube 
available. This is a fibre optic cable that connects 
the keyboard to the computer in the conventional 
way. The second problem occurs when using the 
mouse. If the user positions the keyboard directly 
in front of the computer, it will often block the 
signals from the mouse. This is because the 





computer’s receiving bulb is almost flush with the 
table surface. On the other hand, if you move the 
keyboard to one side, the computer may not be 
able to pick up its signals. 

One of the problems of producing a portable 
version of a desk-top machine is to squeeze all the 
functions into a smaller space. The keyboard 
presents particular difficulties and manufacturers 
have used all kinds of ingenious techniques to pack 
all the necessary functions onto a smaller and 
lighter keyboard. In translating the Apricot 
keyboard to the portable version the manufacturer 
has dispensed with the LCD calculator display and 
packed the 87 keys tightly together. The layout is 
identical to that of the desktop Apricot, except for 
the function keys, which are on the extreme right 
instead of above the main layout. 

Partly to compensate for the loss of the LCD 
display, which in the desk top version is also used 
for single keypress commands, Apricot has added 
an extra function key, making a total of nine, anda 
key to display the time and date. The QWERTY 
keys on the left-hand side of the keyboard are 
flanked on either side by control keys, the cursor 
keys being at bottom right. Between the typewriter 
keys and the function keys is a calculator keypad, 
with the number keys in a lighter shade of grey 
than the rest of the keyboard. 

Although the keyboard appears extremely 
elegant, the keys are perhaps positioned a little too 
close together for comfort. Instead of the 
conventional indented keys, the Portable has a 


QL-style flush keyboard. This makes the keyboard 





Moveable Feast 

The Apricot Portable uses some 
of the very latest technology. 
The machine is equipped with 
an 80 by 25 text screen, which 
allows a wide variety of MS-DOS 
applications to be displayed. 
Also shown here is the keyboard 
and mouse/trackball: these are 
not connected to the computer 
in the conventional sense, but 
transmit signals via an infra-red 
beam. On the right-hand side of 
the computer is the microphone, 
which provides the computer 
with the facility to recognise 
speech 








































more compact, as the keys do not protrude from 
the main body of the keyboard, but many typists 
will find the keyboard design awkward to use as it 
is difficult for the fingers to differentiate between 
the keys. The compactness of the arrangement 
emphasises this problem: there is no gap between 
the typewriter, the calculator and the function 
keys. However, the layout has its compensations. 
Because of the design, the Shift, Stop and Caps 
Lock are twice the size of those on the Apricot, 
making them easier to locate. 

Above the keyboard and in place of the 
calculator display are four buttons to perform 
extra functions. There is a Reset button, which 
reboots the disk currently in the disk drive. The 
second button allows the user to alter the repeat 
rate of the keys. The third calls a routine that resets 
the time held in the computer, and the fourth locks 
the keyboard. This last is useful when you are using 
the mouse or speech input and do not want any 


spurious information input by the accidental press 


of a key. 

The built-in LCD screen is fitted onto the main 
body of the computer. Its clarity is poorer than on 
comparable machines even though the light olive 
background is brighter than most. To the right of 
the screen is a microphone, which is connected by 
a thin wire that plugs into a microjack socket on the 
left of the computer. 


SPEECH RECOGNITION 


Perhaps the most interesting feature of the 
Portable is its speech recognition program, which 
recognises vocal commands, passes them to the 
input and then executes them in the normal way. 
Voice Driven Application mode accepts 
vocabularies of up to 63 words for any 
applications program, such as WordStar or 
SuperCalc. A voice training program, it will ask 
the user whether the voice to be used will be male, 
female, or a child’s, and whether or not there will 
be much background noise. After speaking a 
command several times, the computer will accept 
and compare several variations. However, it still 
misinterprets words and often ignores them 
altogether. For this reason, DELETE and FORMAT 
should not be commanded vocally. 

In common with the rest of the Apricot range, 
the Portable uses Sony 3in disks to hold the 
applications programs. The single disk drive is 
positioned on the right-hand side of the computer. 
On the rear of the machine are three interfaces 
which are covered by a protective plastic casing. 
These are a Centronics parallel slot for printers, an 
RS232 socket for an external modem or other 
serial device and an Atari-standard joystick port. 
This joystick slot is provided not to enable games 
playing but to fit a mouse or trackball in 
circumstances where the infra-red mouse is 
inappropriate. 

The battery-driven infra-red mouse provided 
with the Portable is cleverly designed so that it can 
either be used as a mouse that can be slid around a 
desktop or table or, reversed, it can be held in the 
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CPU — 

The Apricot Portable u uses ihe 
popular 16-bit Intel 8086 as 
its central processing unit 


Port ROMs: on 

As the Portable is a 16-bit 
computer, these chips 
produce the LO-byte and HI- 
byte transmissions to the 
interface board 


Interface Board 
This board contains the chips 
that govern the management 

of the I/O devices, such as the 
printers and disk drive 


hand or kept in a fixed position and used as a 
trackball. The mouse actually works better as a 
trackball, for the user will often find that it has 
been pushed too far across the desk top and 
moved out of the range of the infra-red receiver on 
the computer. 

The Apricot Portable is certainly an interesting 
machine to use. ACT has gone to great pains to 
include the latest technology in its design. 
However, many business users have no intrinsic 
interest in leading-edge technology; what they 
want is a reliable machine that runs their 
applications programs easily and comfortably. By 
this criterion the Apricot Portable scores less weil. 
The difficulty of reading the screen and the 
fallibility of the input devices may result in 
business users turning to more tried and tested 
technology. 


Disk Drive — 

The computer has a single 
double-sided, double density 
inch disk drive, which is 
compatible with other Apricot 
products 





——=| CD Screen 





This screen gives a full 80 by 
20 text display. However, itis 
also possible to produce 
graphics on the screen of a 
high resolution 
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Cutting Remarks 

The Spectrum interface 
components mount onto a piece 
of veroboard cut to this shape. 
Use one of the small corners ~ 
removed as a blanking plug in 
the expansion port connector. 
The extra lip on one end of the 
board will support this 
connector when it is soldered in 
place 





BRIDGING THE GAP 





In our previous Workshop instalment, we 
showed how an interface could be designed - 
for the Spectrum that would mimic the user 
port. Here, we construct the interface, which 
will enable the Spectrum user to control the 





should have the fifth position from left (looking 
into the connector) blanked out. So, our first task 
is to insert a blanking plug into the edge connector 


that will plug into the Spectrum’s expansion port. 


This plug ensures that the finished interface can 
only be inserted into the socket properly 
orientated. Maplin do not supply a suitable plug, 
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but one can be easily made. 

After cutting the veroboard into the shape 
shown, one of the corners can be used as a 
blanking plug. First, strip off the copper track and 
jam the square of stripped board edge-on into the 
fifth position of the edge connector — using a little 
superglue for good measure — then cut off both 
pin connections. Now make thorough track cuts 
on the veroboard, using either a ‘spot face cutter’ 
(available from Maplin; part number FL250) ora 
5mm (zin) twist drill bit. Make sure that each cut 
breaks the whole width of the track, or this could 
mean that besides your interface not working, the 
Spectrum itself could be damaged. 

Having made the track breaks, we can start to 
assemble the components onto the board, 
beginning with the wire links. The links should be 
cut with length to spare and then inserted loosely 
into the board. Solder one end and pull the loose 
end taut before soldering the other. Finally, the 
extra lengths should be cut off close to the board 
with a pair of wire cutters. When all the links have 
been soldered in place, wire in the insulated flying 
lead, using a short length of one strand of the 
ribbon cable. 

After affixing all the links, the edge connector _ 
can now be soldered.into place. But because the 
edge connector system is really designed for 
double-sided boards (as used in the Spectrum 
itself) and not the single-sided veroboard, it is a 
tricky operation. First, bend one row of pins on the 
edge connector as shown. These will form the 
bottom row of pins when the edge connector is 
positioned on the board. Now, solder 3cm (17in) 
lengths of tinned wire onto each of the pins in the 
top row. Insert the bent pins into the row of holes 


‘nearest the board edge and bend each of the 


lengths of wire through 90°, inserting them into the 
other row of holes (marked on the diagram). Now 
put a little superglue on the edge of the board 
between the two cut-out corners and press the 
edge connector home. Solder each pin carefully to 
the tracks of the stripboard. Before continuing, 
check the copper side of the board and clear any 
solder that is bridging across the tracks, using a 
sharp knife. : 

Now solder the rest of the components into 
their places on the board. The three DIL sockets 
should be soldered first, and then the four K-ohm 
resistors. Finally, insert the three chips into 
position, making sure that you insert them the 
right way round. The notches at one end of the 
chips should all be pointing in the same direction 
— to the right when the board is held with the edge 
connector uppermost. 

The interface is now complete. However, 


en ae 


4 





FLYING LEAD 


74827 CHIP 


DIL SOCKETS 


74LS126 CHIP 


TEMPORARY 
TEST WIRES 


74LS75 CHIP 


DIL SOCKET 


WIRE LINKS 


TRACK CUTS 


TEST POINTS 





= BATTERY CONNECTIONS 


EXPANSION PORT CONNECTOR 


15 K-OHM RESISTORS 


KEVIN JONES 





Board Layout 


Solder the wire links and 
resistors in place on the 
component side of the board 
first, then fit the expansion 
port connector and DIL 
sockets. Ensure that all three 
chips are placed in the DIL 
sockets correctly orientated, 
So that all the notches point 
the same way, as shown. 
Check all your work very 
carefully against the diagram 
before attempting to plug the 
interface board into your 
Spectrum. 

On the copper underside, 
make sure that all track cuts 


break the track completely, 


using a meter to test for 
continuity. The links marked 
in green are temporary 
connections for electronic 
testing of the board and 
should be removed after 
successful completion of the 
test. As always, check your 
work thoroughly for mistakes 
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before you can plug it into your Spectrum, it is 
important to thoroughly test it. Since the 
Spectrum’s expansion port allows us unrestricted 
access to the address and data buses, processor 
pins, and the 12v and 9v supplies, it is important 
that we do not inadvertently connect these voltage 
supplies to the delicate electronics that run at TTL 
levels. A visual test should be made first. Go over 
the entire board carefully. Check that there 2Rano 


Sideways Look 


To allow us to use a standard 
edge connector for the interface 
board, we must make slight 
modifications to the pins. 
Having removed the fifth 
position pins, bend over the 
lower set of pins at right-angles 
and solder 3cm lengths of 
tinned wire to the upper set of 
| pins. Push the pins through the 
relevant holes in the board, 
checking that each pin locates 
correctly. The bottom row of 
pins should locate in the third 
row of holes and the upper row 
of pins locate in the sixth row of 
‘holes. Glue the connector in 
place before soldering the pins 
to the board 


EXPANSION PORT 


30M WIRE LINKS CONNECTOR 


VEROBOARD GLUE 


SANOP NIAAX 


bridges of solder between tracks at any point, that 
all the components and wire links are in the right 
place according to the diagrams and that the chips 
are positioned the right way round. 

In the next instalment of Workshop, we shall be 
wiring the ribbon cable that connects the robot to 
the ing#rface board, and looking at Spectrum 
s of some of the previously written robot 

































We conclude our look at the BBC Micro’s 
filmg system ROM routines. There is a 
variety of operating system calls that deal 
with data sent to and accessed from storage 
media. We begin here by considering the 
OSFIND call, a routine that allows us to 
perform ‘byte access’. 





OSFIND is called at address &FFCE and is used to 
open a file for what is called ‘byte access’. ‘This is 
simply the same as opening a file in BASIC using 
OPENOUT, OPENIN or OPENUP. It also enables us to 
close files, in a similar way to the CLOSE# 
operation in Basic. The A register specifies the 
operation to be performed and the X and Y 
registers point to the file name in memory. 


® A=0: This indicates that a file is to be closed. 


Here, the Y register holds the ‘number’ that the file _ in the following table). The ‘sequential pointer’ of 


was given when it was opened. Setting the file 
number to 0 will result in all currently opened files 
being closed. 

@ A=&40: This is equivalent to the BAsic OPENIN 
command. A file is opened for the input of data 
(bytes) only. 

@ A=&80: This is the same as a BASIC OPENOUT. A 
file is opened for output only. 

@ A=& C0: This is equivalent to the BAsic OPENUP. 
Here, a file is open for both input and output. It is 
particularly applicable to any file system that can 
support random access files. 


When were using OSFIND to open a file, however, 
we don’t always succeed. For instance, there might 
be a write protect label on the disk. If the file 
cannot be opened, then A will be set to zero on 
return from OSFIND. If the file is opened 
successfully, the file ‘number’ is returned in the A 
register. This should be saved for future use. 

The next few filing system ROM calls that we'll 
look at all have one thing in common; they all use 
the file number that is generated by OSFIND. 


THE OSARGS CALL 


This routine is called at address &FFDA and 
performs a variety of jobs. It has one peculiarity — 
its parameter block, which is only four bytes long, 
is stored in the zero page. The X register holds the 
address of the first byte of the parameter block, Y 
holds the file number and the A register specifies 
the operation to be carried out. There is a special 
case of OSARGS, when the Y register is set to zero. 
In this case, the routine returns information about 
the filing system in use rather than the file, or 
ensures that all open files on the filing system are 
up to date with regard to data that might still be in 


the buffers for the files. Let’s look at these two 
routines first. 


@ Y=0:A=0: A call to OSARGS with these 
parameters and the X register pointing to a free 
area of the zero page will return filing system 
information. The data will be returned in the A 
register. This OSARGS call is the only one that will 
work on a tape filing system. The data returned in 
the A register by this call is interpreted according 
to the table in the margin. 
® Y=0:A=255: The other call with Y set to zero, 
is when A holds the value 255. A call to OSARGS 
under these conditions will ensure that each file is 
updated from the buffers of the machine. Ifno files 
are open, then the updating cannot take place. 
Y=File Number: If the Y register contains the 
file number, then the operations performed 
depend on the contents of the A register (as shown 


an open file indicates to the operating system 
where the next byte will be written or read. It is 
therefore changed by the Basic PTR# function, as 
well as by these routines. As we might expect, data 
is stored in the zero page parameter block with its 
LSB in address (X+0). When data is read from the 
filing system by OSARGS, it is stored in the 
parameter block for access later. 
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From our Aon of this ae it is nee mile the 
OSARGS parameter block must be in the zero page 
— there’s only the X register to hold the address. 


OSBGET AND OSBPUT 


These routines are used, respectively, to read 
single bytes from an open file and to write single 
bytes to an open file. OSBGET is called at address 
&FFD7, and is simple to use. The Y register is 
loaded with the number of the file — provided by 
OSFIND — and a byte is read in by calling &FFD/. 
The byte is read from the current position of the 
sequential pointer and is returned in A. 
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OSBPUT is the reverse of this operation; it writes 
a byte to the file at the current position of the 
sequential pointer within that file. To use OSBPUT, 
the byte to be written to the file is placed in A, 
while Y holds the file number. A call is then made 
to &FFD4 to execute the call. The short routine 
that follows shows how we might use OSBPUT to 
put a single byte in a file. 


LDA  #&80/ prepare to open a file 
LDX #name MOD 256 

LDY #name DIV 256 

JSR  OSFIND /openthefile 

STA &/1 / store the file number 
TAY / also put it in Y register 
LDA #65 / the byte to be written 
JSR  OSBPUT /doit 

LDA #0 

LDY &/1 / prepare to close file 
JSR  OSFIND /close the file 

RTS / finish 


THE OSGBPB CALL 

This is called at address &FFD1. It transfers groups 
of bytes between memory and open files. It can 
also provide us with information about the Disk 
Filing System, if it is in use. However, here we'll 
just consider its usefulness in data transfer. By the 
way, the call isn’t implemented on the Tape Filing 
System — which isn’t too surprising, because it’s 
only of real use when were using random access 
files from machine code. 

The parameter block for the call is shown in the 
following table, and is pointed to by the contents 
of the X and Y registers, as usual. The A register 
specifies the operation to be performed. 
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Again, if you're using a standard BBC Micro then 
the address is specified by the contents of bytes 1 
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and 4 in the parameter block. 

There are four different types of data transfer 
operation available to us: two read and two write 
operations. One read and one write operation 
access the information in the file at the location 
specified by the sequential pointer entry in the 
above parameter block, whereas the other read 
and write operations ignore this information 
entirely and use the sequential pointer at 
whatever position it happens to be in the file. 
Thus A=1 writes bytes to the pointer specified in 
the block; A=2 writes bytes to the file ignoring 
the parameter block entry; A=3 reads data from 
the sequential pointer specified in the parameter 
block; and A=4 reads bytes but ignores the 
parameter block. The following program uses 
OSGBPB calls to write and read a simple data file: 


1OREM disk system only 

Z0DIMBbl-oek 26 

BSODIM data 100 

40¢data="This is a test program!" 

50 block'i=data:REM address of data ta be 
written 

40block!5=100:REM amount of data to be written 
FUblock!S=0:REM sequential pointer=0 

80 PRINT "Opening the file for output" 
SOY“=OPENOQUTC "FILE"? :REM apen the file 
100block?O=Y"% :REM file number 
110*%=block MOD 256 
120Y%=block DIV 254 
130A%=1: REM prepare to write data 
14g: CAGE “SEF ¢REM dor it 
LSOCLOSE £451 ack 70> 
160 PRINT "Close the file" 
170 TIME =0: REPEAT: UNTIL TIME=400 
180 PRINT "Qpening the file for input" 
170PRINT "Now read the data in!" 


200¢data=STRING#(100," "):REM clear data area 
ZIOYA=OPENINC"FILE"):REM open the file up 
220b]lack?0=7% :REM file number 


230block't=data :REM data address for read 

aperation 

240block'S=100 : REM number of bytes 

250black??=0 : REM sequential pointer to Q 

260X4%=black MOD 254 

27O04=block BIY 256 

280A4=3: REM prepare to read 

270CALL &FFD1 :REM do it 

BSOO0CLOSE£¢ block ?O>d 

310 PRINT “Clase the file again" 

BZ0QFRINT $data 

S3S0END 
The status of the carry flag after the call to &FFD1 
indicates whether the transfer succeeded or not. 
If C contains zero then the transfer was 
completed smoothly. If C is set to one, then the 
transfer failed. 

The final OS call that is concerned with filing 
operations is OSFSC, but this is of minimal use to 
us when were programming. The call is also 
different to the other calls that we’ve mentioned 
here because there is no direct call address for it. 
We have to call it at the address held in its vector. 
In machine code programs, this call can be made 


with the instruction: 
JMP (&21E) 


There are other OS routines that carry out 
specific functions for certain filing systems. For 
example, OSWORD calls are used to access the 
Floppy Disk Controller Chip for the Disk Filing 
System. Also, simple filing system jobs are 
performed by a couple of OSBYTE calls. : 

_ That completes our look at the role of the 
BBC Micro’s operating system in the filing 
operations of the machine. 











DIGITAYA 





This is the final instalment of our adventure 
game programming project series. We give 
here the complete listing of Digitaya, a 
larger game given in tandem with the 
Haunted Forest (see page 997 ). 


The structure of Digitaya has many similarities to 
that of Haunted Forest, but the game is on a much 
larger scale. The original layout for Digitaya 
involved a map of 100 locations, on which was 
drawn the internal layout of a computer, complete 
with memory, data bus, processor and much of the 
other hardware found inside an average home 
computer. The player’s task is to track down the 
mysterious Digitaya, who is held captive 
somewhere inside the machine. You must 
negotiate many hazards, such as the joystick port, 
vector table and random program bugs, using your 


knowledge of a computer’s internal layout to 


rescue Digitaya. 

Digitaya uses similar routines to those of the 
Haunted Forest to carry out the mundane 
functions of the game, such as moving from 
location to location, picking up and dropping 
objects and looking around. However, special 
routines have been added to this skeletal structure 
to cater for the game’s special perils and pitfalls. 

When playing an adventure game it is often 
advisable to map out your route with pencil and 
paper as you move around the adventure world. 
The primary task of the successful adventure game 
player is to get inside the mind of the game's 
creator. Recreating the map of locations used in 
the game is often a good step towards this goal. 
Digitaya is designed on a flat grid, but don’t expect 
all adventure maps to exist in only two dimensions. 
Three-dimensional maps are quite feasible within 
the kind of program structure outlined in the 
project. A game could also be conceived that 
existed in four dimensions, the fourth dimension 
being time. Such a game, built on a constantly 
shifting map, would probably defeat all but the 
most skilled and experienced adventure gamers. 

The listing given is for the Commodore 64, 
although the program will run on most machines 
that have a Microsoft-type Basic. Detailed 
flavours are given for the BBC Micro. 

Some REM statements can be removed from the 
listing to reduce the typing effort, but to ensure the 
program works correctly remove them only from 
the end of the program lines that include other 
code. Lines that contain only REMs are usually 
subroutine titles and their line numbers are used in 
the GOSUB calls. Removing such lines is likely to 
result in an UNDEFINED STATEMENT error. 
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‘Stephanie Brittain reviews three programs for the Commodore 64. 








REVENGE OF THE MUTANT CAMELS 
Llamasoft, £71.95 


Like a million other people, I really enjoyed 
Attack Of The Mutant Camels. In fact I’ve 
never yet found a game by Jeff Minter that isn't 
exceedingly clever and innovative. But I didn’t 
let my past experiences prejudice my 
assessment of this game — I was perfectly 
prepared to dismiss itif it really wasn't any 
good. Nevertheless, Minter's sequel got the 
better of me - it’s too smashing for words. 

The game gives you an amazing sense of 
power - using everything at your disposal to 
knock out shielded death-spitting camels or 
vaulting phone boxes while blasting away at 
moving CND badges intent on your 
destruction (some irony there, surely?), This is 
surrealist humour gone truly beserk: every 
one of the game's 32 levels (the random option 
means that you get a chance to see the higher 
levels anytime you want) is a wonder to behold. 





PERCY THE POTTY PIGEON 
Gremlin Graphics, £7.95 





CAESAR THE CAT 
Mirrorsoft, £8.95 


Driving in London has vanous hazards, 
including the traumas caused by the pigeon's 
well-known aversion to flying where walking 
will do, and thus spnnting out from under your 
wheels as it takes a leisurely stroll across the 
road, The eponymous pigeon featured in this 
game is a truly potty empyreal flapper. Percy 
likes nothing better than flying above the city 
skyline dropping bombs on cars passing on 
the motorway beneath — a sobering tale of 
carmage on the roads. 

Percy, controlled by the joystick, is not totally 
destructive — he also likes to swoop down on 
the motorway (avoiding revengeful motonists) 
to pick up twigs, which he then takes to the 
nearest nest site in the roadside trees. In 
higher levels of play, the hand that rocks the 
joystick must avoid sparrows who steal the 
twigs and hawks who steal the pigeon. 


Caesar is a cute little black and white kitten 
whose aim is to nd the ‘larder’ of mice. The 
larder in question is, in fact, a screen crammed 
full with food and crockery, around which the 
mice scamper, eating food until Caesar 
catches one of them. 

Points are lost if Caesar crashes into a ‘wall’ 
at the side of the screen or knocks over some 
crockery. You also lose points if Caesar takes 
too long over chasing his prey. After you've 
mastered the first level, you can chase faster 
mice on the two higher levels — and that's 
when the fun really begins. Mirrorsoft has 
certainly come up with a fresh concept, and 
deserves full points. There's no other game 
that | can compare with this for novelty — even 
dog lovers will like it. 





